package com.yic.module.wms.service.itemwarehouseinfo;

import java.math.BigDecimal;
import java.util.*;
import javax.validation.*;
import com.yic.module.wms.controller.admin.itemwarehouseinfo.vo.*;
import com.yic.module.wms.dal.dataobject.itemwarehouseinfo.ItemWarehouseInfoDO;
import com.yic.framework.common.pojo.PageResult;

/**
 * 库存明细 Service 接口
 *
 * @author 系统管理员
 */
public interface ItemWarehouseInfoService {

    /**
     * 创建库存明细
     *
     * @param createReqVO 创建信息
     * @return 编号
     */
    Long createItemWarehouseInfo(@Valid ItemWarehouseInfoCreateReqVO createReqVO);

    /**
     * 更新库存明细
     *
     * @param updateReqVO 更新信息
     */
    void updateItemWarehouseInfo(@Valid ItemWarehouseInfoUpdateReqVO updateReqVO);

    /**
     * 删除库存明细
     *
     * @param id 编号
     */
    void deleteItemWarehouseInfo(Long id);

    /**
     * 获得库存明细
     *
     * @param id 编号
     * @return 库存明细
     */
    ItemWarehouseInfoDO getItemWarehouseInfo(Long id);

    /**
     * 获得库存明细列表
     *
     * @param ids 编号
     * @return 库存明细列表
     */
    List<ItemWarehouseInfoDO> getItemWarehouseInfoList(Collection<Long> ids);

    /**
     * 获得库存明细分页
     *
     * @param pageReqVO 分页查询
     * @return 库存明细分页
     */
    PageResult<ItemWarehouseInfoDO> getItemWarehouseInfoPage(ItemWarehouseInfoPageReqVO pageReqVO);

    /**
     * 获得库存明细列表, 用于 Excel 导出
     *
     * @param exportReqVO 查询条件
     * @return 库存明细列表
     */
    List<ItemWarehouseInfoDO> getItemWarehouseInfoList(ItemWarehouseInfoExportReqVO exportReqVO);

    /**
     * 查询库存明细
     * @param itemWarehouseId
     * @return
     */
    List<ItemWarehouseInfoDO> getItemWarehouseInfoList(Long itemWarehouseId);

    /**
     * 查询库存明细
     * @param warehouseId
     * @param areaId
     * @param locationId
     * @param itemWarehouseId
     * @return
     */
    List<ItemWarehouseInfoDO> getItemWarehouseInfoList(Long warehouseId, Long areaId, Long locationId, Long itemWarehouseId);

    /**
     * 变更库存数量
     * @param id
     * @param negate
     */
    void changeStock(Long id, BigDecimal negate);

    /**
     *
     * @param sourceId
     * @param type
     * @return
     */
    ItemWarehouseInfoDO getItemWarehouseInfoBySourceId(Long sourceId, Integer type);
}
